.. _ecmSxMot_OverrideSpeed:

ecmSxMot_OverrideSpeed
======================
----------------------


SYNOPSIS
--------


.. code-block:: none

  t_cmdidx  ecmSxMot_OverrideSpeed(
    t_i32  NetID,
    t_i32  Axis,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- 이 함수는 단축 모션이 진행되고 있는 중에 속도를 변경(오버라이딩)하고자 할 때 사용하는 함수입니다.
 
- 속도를 오버라이딩하기 위해서는 먼저 ecmSxCfg_SetSpeedPatt() 속도 패턴 설정 함수를 통하여 변경하고자 하는 속도 또는 가속도값을 설정하고 나서 이 함수를 수행해야 합니다.



PARAMETER
---------


- NetID : Network 번호

- Axis : 대상 축 번호.

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- 이 리턴값은 함수의 cmdidx가 반환됩니다.

EXAMPLE
-------


.. code-block:: cpp
  :linenos:


  C/C++
  #include "ComiEcatSdk_Api.h"
  #define AXIS0   0

  t_32 Error_Num =  0;//함수 별  에러 코드 저장 변수

  /***************************************************************
  * 프로그램 앞 부분은 생략 -> ecmSxMot_MoveStart 예제 참고
  ***************************************************************/

  /**************************************************************
  * DO_OverrideSpeed: 작업 명령 시에 호출되는 가상의 함수 입니다.
  *cmsSetCfgSetSpeedPattern으로 설정된 첫번째 축(Axis)의 속도모드를
  * 함수에서 재 설정 한 속도로 바꾸어 이송을 진행하는 함수
  ***************************************************************/
  void DO_OverrideSpeed ()
  {
        ecmSxCfg_SetSpeedPatt(Device_Info.NetIdx, AXIS0, 0, 0, 40000, 10000, 10000, &Error_Num );      //SpeedPatt 재 설정
        ecmSxMot_OverrideSpeed (Device_Info.NetIdx,  AXIS0, &Error_Num);
        //재 설정 된 SpeedPatt으로 남은 이송 진행

  }